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PREFACE 


This  development  specification  covers  the  work  performed 
under  Air  Force  Contract  F33615-80-C-5155  (ICAM  Project  6201). 
This  oontract  is  sponsored  by  the  Materials  Laboratory,  Air 
Force  Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio. 

It  was  administered  under  the  technical  direction  of  Mr.  Gerald 
C.  Shumaker,  ICAM  Program  Manager ,  Manufacturing  Technology 
Division,  through  Project  Manager ,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 


Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

D.  Appleton  Company 
(DACOM) 


General  Dynamics/ 
Ft.  Worth 


Role 

Reviewer . 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search . 

Responsible  for  factory  view 
function  and  information 
models . 
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Subcontractors 


Role 


Illinois  Institute  of  Responsible  for  factory  view 

Technology  function  research  (IITRI) 

and  information  models  of 
small  and  medium-size  business. 


North  American  Rockwell  Reviewer. 


Northrop  Corporation 

Pritsker  and  Associates 
SofTech 


Responsible  for  factory  view 
function  and  information 
models . 

Responsible  for  IDEF2  support. 
Responsible  for  IDEFO  support. 


TASKS  4.5  -  4.9  (TEST  BED) 
Subcontractors  Role 


Boeing  Military  Aircraft 
Company  (BMAC) 


Computer  Technology 
Associates  (CTA) 


Control  Data  Corporation 
(CDC) 


Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 


D.  Appleton  Company  Responsible  for  the  overall  CDM 

(DACOM)  Subsystem  design  integration 

and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonne 1 1  Doug las 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM . 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  0  Dodge) 


Sof Tech ,  Inc . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  implementation  aund  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems . 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
(BMAC) 


1701,  2201,  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC ) . 
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Contractors 

Control  Data 
Corporation  (CDC) 


D.  Appleton  Company 
(DACOM) 

General  Electric 


Hushes  Aircraft 
Company  (HAC) 

Structural  Dynamics 
Research  Corporation 
(SDRC) 


I  CAM  Project  Contributing  Activities 

1502,  1701  IISS  enhancements  to 

Common  Data  Model 
Processor  (CDMP). 

1502  IISS  enhancements  to 

Integration  Methodology. 

1502  Operation  of  the  Test 

Bed  and  communications 
equipment . 

1701  Test  Bed  enhancements. 


1502,  1701,  IISS  enhancements  to 
1703  User  Interface/ Virtual 

Terminal  Interface 
CDI/VTI). 


Ii 


Systran 


1502 


Test  Bed  enhancements . 
Operation  of  Test  Bed. 
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A-25  Before  Fill  of  Cut  Buffer  -  margins  changed 

to  40  70  (3. 2. 1.1. 10. 4. a)  .  A-26 

A-26  After  Fill  of  Cut  Buffer  (3.2. 1 . 1 . 10.4. b)  ..  A-27 

A-27  Before  Load  File  (3.2.1 .2. 3. a)  .  A-28 

A-28  After  Load  File  (3 . 2 . 1 . 2 . 3 . b)  .  A-29 

B-l  Before  Select  for  Cut  and  Paste  .  B-2 

B-2  After  Select,  Before  Delete  Line  .  B-3 

B-3  After  Delete  Line,  Before  Paste  .  B-4 

B-4  After  Paste,  Before  Fill  .  B-5 

B-5  After  Fill  .  B-6 


DS  620 1 44600B 
1  November  1985 


SECTION  1 
SCOPE 


1 . 1  Ident i f i cat i on 


This  specification  establishes  the  perf ormance , 
development,  test,  and  qualification  requirements  of  a  computer 
program  identified  as  the  Text  Editor  (TE).  The  Text  Editor  is 
one  configuration  item  of  the  Integrated  Information  Support 
System  (IISS)  User  Interface  (01). 

1 .2  Functional  Summary 

The  Text  Editor  provides  the  user  with  the  ability  to  edit 
a  file  in  a  manner  consistent  with  the  User  Interface.  It  also 
provides  some  extensions  to  the  User  Interface  Form  Processor 
for  text  editing  within  form  data  areas.  Editing  functions  such 
as  inserting,  deleting,  moving  and  replacing  text  are  available. 
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SECTION  2 
DOCUMENTS 


2.1  Reference  Documents 


[1]  ICAM  Documentat 1 on  Standards ,  ICAM  Document  IDS 
150120000C ,  15  September  1983. 

[2]  Structural  Dynamics  Research  Corporation,  Virtual 
Terminal  Development  Specification ,  DS  620144300B, 
November  1,  1985. 

[3]  Structural  Dynamics  Reasearch  Corporation,  Form 
Processor  Development  Specification,  DS  620144200B, 
November  1 ,  1985 . 

[4]  Structural  Dynamics  Research  Corporation,  User 
Interface  Development  Specification,  DS  620144100B, 

1  November  1985. 

[5]  Structural  Dynamics  Researoh  Corporation,  Appl ication 
Interface  Devleopment  Specification,  DS  620144700, 

1  November  1985. 

[6]  Structural  Dynamics  Reseraoh  Corporation.  Rapid 
Appl ication  Generator  Deve 1 opment  Specification, 

DS  620144502  ,  1  November  1985. 

[7]  Structural  Dynamics  Research  Corporation,  Forms 
Driven  Form  Editor  Development  Specif lotion, 

DS  620144402B ,  1  November  1985. 

[8]  Structural  Dynmics  Research  Corporation,  Forms 
Language  Compiler  Development  Specification. 

DS  620144401 B ,  1  November  1985. 
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[9]  General  Electric  Co.,  System  Design  Specification, 
7  February  1983 . 

2.2  Terms  and  Abbreviations 


Buffer  Name :  the  default  file  in  which  the  buffer  will  be 
saved  if  no  file  is  given  on  a  save  command. 

Current  Cursor  Position:  the  position  of  the  cursor  before 
an  edit  command  or  function  is  issued  in  the  text  editor. 

Cursor  Position :  the  position  of  the  cursor  after  any 
command  is  issued. 

Cut  and  Paste  Buffer :  where  deleted  lines  go  and  the  paste 
and  fill  edit  commands  get  their  data. 

Display  Start  Line:  the  first  line  in  the  buffer  to  be 
displayed . 

Display  Size:  the  number  of  lines  used  in  the  edit  area. 

Field:  two-dimensional  space  on  a  terminal  screen. 

Field  Pointer:  indicates  the  ITEM  which  contains  the 
current  cursor  position. 

Form  Processor :  (FP),  subset  of  the  IISS  User  Interface 
that  consists  of  a  set  of  callable  execution  time  routines 
available  to  an  application  program  for  form  processing. 

Form  Processor  Text  Editor :  (FPTE),  subset  of  the  Form 
Processor  that  consists  of  software  modules  that  provide  text 
editing  capabilities  to  all  users  of  applications  that  use  the 
Form  Processor . 

IISS  Function  Screen :  the  first  screen  that  is  displayed 
after  logon.  It  allows  the  user  to  specify  the  function  he 
wants  to  access  and  the  device  type  and  device  name  on  which  he 
is  working. 

Integrated  Information  Support  System:  (IISS),  a  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
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heterogeneous  data  bases  supported  by  heterogeneous  computers 
Interconnected  via  a  Local  Area  Network. 

Item:  non-decomposable  area  of  a  form  in  which  hard-coded 
descriptive  text  may  be  placed  and  the  only  defined  areas  where 
user  data  may  be  input/output. 

Message:  descriptive  text  which  may  be  returned  in  the 
standard  message  line  on  the  terminal  screen.  They  are  used  to 
warn  of  errors  or  provide  other  user  information. 

Message  Line :  a  line  on  the  terminal  screen  that  is  used  to 
display  messages. 

Operating  System:  (OS),  software  supplied  with  a  computer 
which  allows  it  to  supervise  its  own  operations  and  manage 
access  to  hardware  facilities  such  as  memory  and  peripherals. 

Paging  and  Scrolling:  a  method  which  allows  a  form  to 
contain  more  data  than  can  be  displayed  with  provisions  for 
viewing  any  portion  of  the  data  buffer. 

Previous  Cursor  Position:  the  position  of  the  cursor  when 
the  previous  edit  command  was  issued. 

Previous  Edit  Command:  the  function  key  pressed  before  the 
current  one. 

Select  Line:  one  terminus  of  the  select  range. 

Select  Mode:  when  on,  certain  commands  will  be  executed 
over  the  lines  in  the  selected  range.  The  commands  are  <DELETE 
LINE >  and  replace. 

Text  Editor:  (TE),  subset  of  the  IISS  User  Interface  that 
consists  of  a  file  editor  that  is  based  on  the  text  editing 
functions  built  into  the  Form  Processor. 

Top  of  file :  the  first  line  of  the  buffer. 

Oser  Interface:  (UI),  IISS  subsystem  that  controls  the 
user's  terminal  and  interfaces  with  the  rest  of  the  system.  The 
UI  consists  of  two  major  subsystems:  the  User  Interface 
Development  System  (UIDS)  and  the  User  Interface  Management 
System  (UIMS). 
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Pser  Interface  Development  System:  (DIDS),  collection  of 
IISS  User  Interface  subsystems  that  are  used  by  applications 
programmers  as  they  develop  IISS  applications.  The  UIDS 
includes  the  Form  Editor  and  the  Application  Generator. 

Pser  Interface  Services :  (UIS),  subset  of  the  IISS  User 
Interface  that  consists  of  a  package  of  routines  that  aid  users 
in  controlling  their  environment.  It  includes  message 
management,  change  password,  and  application  definition 
services . 

Virtual  Terminal :  (VT),  subset  of  the  IISS  User  Interface 
that  performs  the  interfacing  between  different  terminals  and 
the  UI .  This  is  done  by  defining  a  specific  set  of  terminal 
features  and  protocols  which  must  be  supported  by  the  UI 
software  which  constitutes  the  virtual  terminal  definition. 
Specific  terminals  are  then  mapped  against  the  virtual  terminal 
software  by  specific  software  modules  written  for  each  type  of 
real  terminal  supported. 
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SECTION  5 
REQUIREMENTS 


3.1  Computer  Program  Definition 

The  Text  Editor  is  an  IISS  application  and  as  such  can  be 
invoked  fro*  the  IISS  function  menu.  It  provides  IISS  users 
with  file  editing  capabilities. 

The  Text  Editor  also  works  in  conjunction  with  the  User 
Interface  Form  Processor  (FP)  to  provide  the  ability  to  edit 
ITEMs  displayed  on  a  form.  In  this  mode  it  is  referred  to  as 
the  Form  Processor  Text  Editor  (FPTE)  and  can  be  invoked  by  the 
terminal  user  of  any  application  that  uses  the  Form  Processor. 
Editing  functions  such  as  inserting,  deleting,  moving,  and 
replacing  text  are  available.  Some  commands  are  not  available 
in  the  FPTE  and  others  have  a  slightly  different  meaning.  This 
is  because  when  editing  a  file,  the  file  is  placed  in  a  buffer 
of  which  a  portion  is  displayed  on  the  screen  where  as  with  an 
ITEM  all  of  its  data  are  displayed.  The  differences  in  commands 
are  due  to  file  manipulation  and  requirements  to  display  various 
parts  of  the  file  buffer. 

The  Text  Editor  has  two  basic  modes,  edit  and  command. 
Usually  you  are  in  the  edit  mode  entering  text  and  using  key 
commands,  called  functions.  The  command  mode  is  entered  by 
pressing  the  < COMMAND*  key  in  the  edit  mode.  The  command  mode 
is  exited  by  completing  a  command  or  by  pressing  the  <QUIT>  key. 

Help  is  available  for  both  modes. 

The  conditions  under  which  an  error  occurs  and  its  handling 
are  listed  under  each  function.  In  general  if  an  error 
condition  occurs  the  function  is  aborted  and  a  message  is 
displayed  warning  of  the  failure. 

3.1.1  Interface  Requi remen ts 

3. 1.1.1  Interface  Block  Diagram 

Figure  3-1  describes  the  structure  of  the  TE  interfaces. 
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Figure  3-1  Text  Editor  Interfaces 


3. 1.1. 2  Detailed  Interface  Definition 

The  TE  is  really  two  entities.  As  an  application  function, 
it  is  capable  of  editing  files.  In  this  role  it  is  a  form 
processor  application.  The  FPTE  is  a  mode  of  the  Form 
Processor.  In  this  role  it  is  available  for  editing  ITEHs  of 
any  application.  They  have  a  common  set  of  functions  and 
commands . 

The  Text  Editor,  when  run  as  a  Form  Processor  application, 
is  invoked  by  filling  in  the  FUNCTION  item  on  the  IISS  function 
form  with  SDTEZZZZZZ.  As  a  Fora  Processor  application  it  has 
been  linked  using  the  Application  Interface  routines.  The  Text 
Editor,  when  run  as  a  mode  of  the  Form  Processor,  is  invoked  by 
pressing  the  <MODE>  key  until  "text  editor"  appears  in  the 
bottom  right  hand  corner  of  the  screen. 
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The  Text  Editor  may  also  be  invoked  from  another 
application.  Two  parameters  must  be  passed  to  EDITCI  routine: 
first  the  name  of  the  file  to  be  edited  (up  to  SO  characters) 
and  second,  a  flag  variable  which  i6  set  to  TRUE  if  the  file  was 
written,  otherwise  FALSE. 

3.2  Detailed  Functional  Requirements 


3-2.1  File  Editing 
3.2. 1 . 1  Edit  Mode 


In  addition  to  being  able  to  enter  text  in  the  edit  mode 
the  following  commands  are  available  through  the  function  keys. 
A  phrase  enclosed  in  angle  brackets  denotes  a  key.  Some 

commands  are  implemented  through  the  Virtual  Terminal  (VT). 
They  are  listed  below: 


<UP  ARROW > 


Moves  the  cursor  up  one  line. 


<  DOWN  ARROW » 


<LEFT  ARROW. 


Moves  the  cursor  down  one  line.  Note 
that  these  keys  do  not  scroll  the 
screen.  The  scroll  keys  do  that. 

Moves  the  cursor  left  one  character. 


< RIGHT  ARROW. 


<TAB> 


<  BACK  TAB. 


Moves  the  cursor  right  one  character. 
Note  that  the  cursor  will  not  “wrap 
around" . 

Moves  the  cursor  to  the  start  of  the 
next  line.  Except  when  on  the  next  to 
last  line  when  the  cursor  will  move  to 
the  message  number  field  (MSG:). 

Moves  the  cursor  to  the  start  of  the 
previous  line.  Except  when  on  the  first 
line  when  the  cursor  will  move  to  the 
message  number  field  (MSG:). 


<DELETE  CHARACTER.-  Shift  left  one  character  the  character 

from  just  right  of  the  cursor  to  the  end 
of  the  line.  The  right  most  character 
in  the  line  is  replaced  with  a  blank. 
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< INSERT  CHARACTER)-  Shift  right  one  character  the  character 

from  the  cursor  position  to  the  end  of 
the  field  line.  The  right  most 
character  in  the  line  are  lost  and  the 
vacated  character  position  is  filled 
with  a  blank. 


The  following  group  of  functions  are  implemented  through  the 
TE  itself  and  accessible  by  function  keys  on  the  terminal. 
Appendix  C  contains  keypad  layouts  for  a  VT100  terminal . 


< COMMAND  MODE> 
< DELETE  LINE) 

< INSERT  LINE) 
<NEXT  LINE) 


<  PREVIOUS  LINE. 


<NEXT  PAGE) 


« PREVIOUS  PAGE. 


« FIRST  PAGE) 
<LAST  PAGE) 

< MIDLINE  BREAK) 
< SELECT) 

<  PASTE  > 

<  FILL  > 

<QUIT> 

< SEARCH  NEXT> 


In  scroll /page  mode  use  vertical  scroll 
up  (see  Terminal  Operator's  Guide  on 
paging  and  scrolling). 

In  scroll /page  mode  use  vertical  scroll 
down  (see  Terminal  Operator's  Guide  on 
paging  and  scrolling). 

In  scroll /page  mode  use  vertical  page  up 
(see  Terminal  Operator's  Guide  on  paging 
and  scrolling). 

In  scroll/page  mode  use  vertical  page 
down  (see  Terminal  Operator's  Guide  on 
paging  and  scrolling). 


Figure  3-2  Shows  the  editing  form.  For  a  VT100  the  top 
22  lines  are  used  for  the  editing  area.  The  line  marked  with 
the  " > > "  is  the  command  line. 


DS  620144600B 
1  November  1985 


$! 

$: 

v« 


i 


'il 

•7 


r 

i 


A'l 

' 

a 

i? 


*'w 

§ 


v«i 


Figure  3-2  Edit  Mode  Form 


3. 2. 1.1.1  Edit  to  Command  Mode 


< COMMAND* 


In  the  edit  mode  this  is  used  to  switch 
to  the  command  mode. 


There  are  no  error  conditions  with  this  function. 

3. 2. 1.1. 2  Scroll  Op 

< SCROLL  OP(FP  FUNCTION) >  -  Scroll  the  displayed  portion  of 

the  buffer  up  by  one  line.  Push  the  top 
displayed  line  into  the  nondi splayed 
portion  of  the  buffer  and  display  the 
line  in  the  buffer  which  follows  the 
last  line  displayed. 

If  the  display  start  line  is  the  bottom  of  the  file  the 
function  is  aborted  and  a  message  warning  of  the  condition  is 
issued . 

In  Appendix  A  see  figure  A-5  (before)  and  A-6  (after)  a 
Next  Line  (Scroll  Up). 

3. 2. 1.1. 2.1  Input 

Top  of  File. 

Bottom  of  File. 

Display  Start  Line. 

Current  Cursor  Position. 
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3. 2. 1.1. 2. 2  Output 
Display  Start 

Line  -  This  is  moved  to  the  next  line. 

Cursor  Position  -  This  is  moved  to  the  next  line. 

3. 2. 1.1. 3  Scroll  Down 

< SCROLL  DOWN(FP  FUNCTION) >  -  This  is  similar  to  <SCROLL  UP> 

except  that  the  display  is  scrolled 
down . 

If  the  display  start  line  is  just  after  the  top  of  file 
mark,  then  the  function  is  aborted  and  a  warning  message  is 
issued . 

In  Appendix  A  see  figure  A-7  (before)  and  A-8  (after)  a 
Previous  Line  (Scroll  Down). 

3.2. 1 . 1 .3. 1  Input 

Top  of  File. 

Bottom  of  File. 

Display  Start  Line. 

Current  Cursor  Position. 

3. 2. 1.1. 3. 2  Output 
Display  Start 

Line  -  This  is  moved  to  the  previous  line  in 

the  TE  buffer. 

Cursor  Position  -  This  is  moved  to  the  previous  line  in 

the  TE  buffer . 


3 . 2 . 1  . 1  . 4  Page  Ui 


< PAGE  UP  (FP  FUNCTION ) >  -  The  display  is  scrolled  up  by  the 

display  size. 


If  the  display  start  line  is  the  bottom  of  file  mark  then 
the  function  is  aborted  and  a  warning  message  is  issued. 

In  Appendix  A  see  figure  A-9  (before)  and  A-10  (after)  a 
Next  Page  (Page  Up). 
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3. 2. 1.1. 4.1  Input 

Top  of  File. 

Bottom  of  File. 

Display  Start  Line. 
Current  Cursor  Position. 

3. 2. 1.1. 4. 2  Output 


Display  Start 
Line 


Line  -  This  is  moved  forward  in  the  TE  buffer 

by  display  size  lines. 

Cursor  Position  -  This  is  moved  forward  in  the  TE  buffer 

by  display  size  lines. 

3. 2. 1.1. 5  Page  Down 

< PAGE  DOWN  (FP  FUNCTION ) >  -  The  display  is  scrolled  down  by 

the  display  size. 

If  the  display  start  line  is  just  after  the  top  of  file 
mark  then  the  function  is  aborted  and  a  warning  message  is 
issued. 

In  Appendix  A  see  figure  A-ll  (before)  and  A-12  (after)  a 
Previous  Page  (Page  Down). 

3.2. 1 . 1 .5. 1  Input 

Top  of  File. 

Bottom  of  File. 

Display  Start  Line. 

Current  Cursor  Position. 

3. 2. 1.1. 5. 2  Output 

Display  Start 

Line  -  This  is  moved  backward  in  the  TE  buffer 

by  display  size  lines. 

Cursor  Position  -  This  is  moved  backward  in  the  TE  buffer 

by  display  size  lines. 


3. 2. 1.1. 6  First  Page 


i FIRST  PAGE; 


Displays  the  first  display  Eize  lines  of 
the  buffer. 
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There  are  no  error  conditions  with  this  function. 

In  Appendix  A  see  figure  A-13  (before)  and  A-14  (after)  a 
First  Page. 

3.2. 1 . 1 .6. 1  Input 

Top  of  File. 

Bottom  of  File. 

Display  Start  Line. 

Current  Cursor  Position. 

3. 2. 1.1. 6. 2  Output 
Display  Start 

Line  -  This  is  moved  to  Top  of  File. 

Cursor  Position  -  This  is  moved  to  Top  of  File. 

3. 2. 1.1. 7  Last  Page 

<LAST  PAGE >  -  Displays  the  last  display  size  lines  of 

the  buffer. 

There  are  no  error  conditions  with  this  function. 

In  Appendix  A  see  figure  A-15  (before)  and  A-16  (after) 
a  Last  Page. 

3. 2. 1.1. 7.1  Input 

Top  of  File. 

Bottom  of  File. 

Display  Start  Line. 

Current  Cursor  Position. 

3. 2. 1.1. 7. 2  Output 
Display  Start 

Line  -  If  there  are  more  than  display  size 

lines  in  the  TE  buffer  this  is  moved  to 
a  line  display  size  backward  from  the 
bottom  of  file.  If  there  are  fewer  them 
display  size  lines  in  the  TE  buffer  this 
is  moved  to  Top  of  file. 

This  is  moved  to  bottom  of  file. 


Cursor  Position 


DS  620144600B 
1  November  1985 


3. 2. 1.1. 8  Insert  Line 

< INSERT  LINE >  -  Move  down  one  line  the  line  containing 

the  cursor  and  all  following  lines.  The 
last  line  is  pushed  into  the 
nondisplayed  portion  of  the 
buffer  and  the  line  containing  the 
cursor  is  filled  with  blanks. 

The  TE  does  not  permit  insert  lines  to  be  done  on  lines 
following  the  bottom  of  file  mark.  An  attempt  to  do  so  aborts 
the  function  and  a  warning  message  is  issued.  If  the  TE  is 
unable  to  allocate  sufficient  memory  for  the  new  line  a  message 
is  displayed  warning  of  the  condition  and  the  operation  is 
aborted.  Since  many  functions  use  insert  line  this  last 
condition  may  occur  in  several  places:  midline  break,  select, 
paste,  fill,  and  load  a  file.  It  is  expected  that  this  will  be 
a  rare  condition. 

In  Appendix  A  see  figure  A-3  (before)  and  A-4  (after)  an 
< INSERT  LINE> . 

3.2. 1 . 1 .8 . 1  Input 

Top  of  File. 

Bottom  of  File. 

Display  Start  Line. 

Current  Cursor  Position. 


3 . 2 . 1  . 1 . 8 . 2 

Output 

Display 

Start 

Line 

If  the  cursor  was  on  the  display  start 
line  prior  to  the  function  then  the  new 
display  start  line  is  the  line  that  was 
just  inserted. 

Cursor 

Position 

The  cursor  is  moved  the  the  line  that 
was  just  inserted  (i.e.  the  same 
physical  line  on  the  screen). 

3. 2. 1.1. 9  Midline  Break 

< MIDLINE  BREAK >  -  All  characters  from  the  cursor  position 

to  the  end  of  the  line  are  removed  and 
inserted  at  the  beginning  of  a  newline 
immediately  following  the  cursor's  line 
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A  midline  break  is  not  permitted  on  the  bottom  of  file  mark 
or  any  following  line.  If  attempted  the  function  is  aborted  and 
a  warning  is  issued.  If  the  insert  line  fails  the  midline  break: 
will  be  aborted  as  well. 

In  Appendix  A  see  figure  A-17  (before)  and  A-18  (after)  a 
Midline  Break. 

3. 2. 1.1. 9.1  Input 

Top  of  File. 

Bottom  of  File. 

Display  Start  Line. 

Current  cursor  Position. 

3. 2. 1.1. 9. 2  Output 

Cursor  position  -  The  cursor  is  moved  to  the  start  of  the 

newl ine . 

3.2.1.1.10  Cut  and  Paste  Scenario 

Move  the  cursor  to  the  first  line  to  move  and  press  the 
< DELETE  LINE >  key  for  the  n  consecutive  lines  to  be  moved. 
Alternately,  to  move  large  blocks  of  text,  move  the  cursor  to 
the  first  line  to  move  and  press  < SELECT >  then  move  the  cursor 
to  the  last  line  to  move  and  press  < DELETE  LINE>.  Next  move  the 
cursor  to  the  line  where  the  lines  are  to  be  pasted  then  press 
the  < PASTE*  key  or  <FILL>  key.  The  < PASTE*  key  will  restore  the 
deleted  lines  in  exactly  the  sane  format  they  were  when  deleted. 
The  <FILL>  key  will  restore  the  deleted  lines  and  fill  each 
newline  to  the  extent  of  the  current  fill  margins  with  as  many 
words  as  possible  from  the  paste  buffer.  A  word  is  a  sequence 
of  nonblank  printable  characters.  Note  that  the  lines  remain  in 
the  cut  and  paste  buffer  until  another  < DELETE  LINE*  is  issued 
so  the  lines  may  be  pasted  in  as  many  places  as  required.  The 
< SELECT*  mode  may  be  cancelled  by  pressing  < SELECT*  again 
without  pressing  < DELETE  LINE* . 

In  Appendix  A  see  figures  A-19,20,21,  and  22  for  how  the 
lines  are  put  into  the  cut  and  paste  buffer,  figures  A-23  and 
24  for  a  paste,  and  figures  a-25  and  26  for  a  paste  with  fill 
(margins  at  40  and  70). 
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S. 2. 1.1. 10.1  Select  for  Cut  and  Paste 

< SELECT >  -  A  < MIDLINE  BREAK >  is  performed  and  the 

line  after  the  cursor  is  marked  as  one 
terminus  of  the  select  range  for 
deletion.  This  position  is  marked  on 
the  screen  with  a  special  line. 

If  the  select  mode  is  currently  on,  it 
is  cancelled. 

Select  is  not  permitted  on  the  bottom  of  file  mark  or  any 
following  lines.  An  attempt  to  do  so  will  abort  the  function 
and  a  warning  message  will  be  issued.  Select  uses  insert  line 
to  display  the  select  marker.  If  the  insert  line  fails  the 
select  is  aborted. 

In  Appendix  A  see  figure  A-19  (before)  and  A-20  (after)  a 
Select . 


3.2.1.1.10.1.1  Input 

Current  Cursor  Position. 
Select  Mode. 


3.2.1.1.10.1.2  Output 


Cursor  Position 


Select  Mode 
Select  Line 
Terminus 


If  the  select  mode  is  off,  the  cursor  is 
moved  to  the  start  of  line  containing 
the  select  line  marker.  If  the  select 
mode  is  on  the  cursor  position  is 
unchanged . 

Toggled  from  its  input  status. 

Indicates  a  position  in  the  TE  buffer  as 
a  terminus  for  deletion. 


3.2.1.1.10.2  Delete  a  Line  of  Text 


< DELETE  LINE>  -  The  characters  from  the  cursor  position 

to  the  end  of  the  line  are  deleted.  The 
cursor  i6  moved  to  the  start  of  the  next 
line.  If  the  cursor  was  at  the 
beginning  of  the  line  all  lines  which 
follow  are  scrolled  up  one.  One  of  the 
following  things  happen  to  the  line: 
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1.  If  the  select  mode  is  on,  all  the  lines  in  the  selected 

range  replace  the  contents  of  the  cut  and  paste  buffer. 

2.  If  the  select  mode  is  off  and  the  previous  function  was 

a  delete  and  the  user  has  not  moved  the  cursor,  the  line  is 
concatenated  to  the  cut  and  paste  buffer. 

3.  If  the  select  mode  is  off  and  the  previous  function  is 
not  the  sane  as  the  current  (< DELETE  LINE> )  or  the  user  has 
moved  the  cursor,  the  line  replaces  the  contents  of  the  cut  and 
paste  buffer. 

The  TE  does  not  permit  the  line  containing  the  bottom  of 
file  marker  or  any  following  lines  to  be  deleted.  An  attempt  to 
do  so  is  aborted  and  a  warning  message  is  issued.  The  cursor 
may  be  in  column  one  of  the  line  containing  the  bottom  of  file 
marker  if  the  select  mode  is  on. 

In  Appendix  A  see  figure  A-l  (before)  and  A-2  (after)  a 
< DELETE  LINE.. 


3.2.1.1.10.2.1  Input 


Top  Of  File 
Bottom  Of  File 
Display  start 
1  ine 

Previous  Edit 
Command 

Previous  Cursor 
Position 

Select  Mode 

Select  Line 


Current  Cursor 
position 


First  line  of  text  in  TE  buffer. 

Last  line  of  text  in  the  TE  buffer. 

The  first  line  of  the  TE  buffer  to  be 
displayed. 

This  is  required  for  the  cut  and  paste 
operation  (see  below). 

This  is  required  for  the  cut  and  paste 
operation . 

If  this  mode  is  on  then  all  lines  in  the 
select  range  are  deleted. 

If  the  select  mode  is  on  then  all  lines 
between  the  selected  line  and  the 
current  cursor  line  inclusive  are 
deleted . 

This  is  the  line  the  cursor  is  currently 
on. 


Cut  and  Paste  Buffer. 
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3.2.1.1.10.2.2  Output 

Display  Start  Line-  If  the  cursor  was  on  the  Display  start 

line  then  the  display  start  line  is  move 
to  the  next  line. 

Cursor  Position  -  The  cursor  will  be  positioned  at  the 

beginning  of  the  line  which  follows  the 
deleted  line(s).  This  will  enable  a 
< PASTE >  or  < FILL>  command  to  be  issued 
immediately  afterward  without  the 
user  having  to  move  the  cursor. 

Select  Mode  -  Set  to  False. 

Cut  and  Paste  Buffer . 

3.2.1.1.10.3  Paste  for  Cut  and  Paste 

< PASTE >  -  This  will  insert  the  contents  of  the  cut 

and  paste  buffer  (exactly  as  they  appear 
in  that  buffer)  into  the  TE  buffer  just 
before  the  line  containing  the  current 
cursor  position. 

A  paste  is  not  permitted  on  any  line  following  the  bottom 
of  file  mark.  An  attempt  to  do  so  will  abort  the  function  and  a 
warning  message  will  be  issued.  Since  paste  uses  insert  line  if 
it  fails  then  paste  will  be  aborted. 

In  Appendix  A  see  figure  A-23  (before)  and  A-24  (after)  a 
Paste . 

3.2.1.1.10.3.1  Input 

Top  of  File. 

Bottom  of  File. 

Current  Cursor  Position. 

Cut  and  Paste  Buffer. 

Display  Start  Line. 

3.2.1.1.10.3.2  Output 

Display  Start 

Line  -  This  is  moved  so  that  only  lines  above 

the  cursor  position  are  changed. 
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3.2.1.1.10.4  Fill  for  Cut  and  Paste 

< FILL >  -  The  contents  of  the  cut  and  paste  buffer 

are  inserted  into  the  TE  buffer  just 
before  the  line  containing  the  current 
cursor  position. 

Unlike  <PASTE>,  <FILL>  will  place  as 
many  whole  words  on  each  line  within  the 
current  fill  margins.  A  word  is  defined 
as  a  sequence  of  nonblank  printable 
characters . 

If  a  word  is  to  large  to  fit  within  these  margins  it  is 
wrapped  and  a  warning  message  is  issued.  A  fill  is  not 
permitted  on  any  line  after  the  bottom  of  file  mark.  An  attempt 
to  do  so  will  be  aborted  and  a  warning  message  will  be  issued. 
Since  fill  uses  insert  line  if  it  fails  then  fill  will  be 
aborted. 

In  Appendix  A  see  figure  A-25  (before)  and  A-26  (after)  a 

Fill . 


3.2.1.1.10.4.1  Input 

Top  of  File. 

Bottom  of  File. 

Current  Cursor  Position. 

Cut  and  Paste  Buffer. 

Display  Start  Line. 

Fill  Margins  -  Two  values  which  satisfy  the  following 
constraint : 

0  < *  left  margin  <  right  margin  <«  display  width. 

3.2.1.1.10.4.2  Output 
Display  Start 

Line  -  This  is  moved  so  that  only  lines  above 

the  cursor  position  are  changed. 

Cursor  Position  -  Moved  to  the  line  following  the  pasted 

1 ines . 

3.2.1.1.11  Quit  the  TE 


Terminates  the  edit  or  command  mode.  If 
in  the  edit  mode  and  the  buffer  has  been 
modified  since  the  initial  load  or  last 
save,  you  must  press  the  <QUIT>  key 


<QUIT> 


avovnv 


u 
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twice.  Pressing  another  function  key 
the  second  time  returns  to  the 
edit  mode.  If  in  the  command  mode  it 
returns  to  the  edit  mode  without 
executing  a  command. 

There  are  no  error  conditions  with  this  function. 

3.2.1.1.11.1  Input 

TE  buffer  change 

flag  -  True  if  the  buffer  has  been  modified 

since  it  was  loaded  or  the  last  save. 

3.2.1.1.12  Search  Next 

< SEARCH  NEXT>  -  The  most  recently  executed  search 

command  will  be  repeated.  The  error 
conditions  are  the  same  as  for  the 
< SEARCH>  function. 

3.2.1.1.12.1  Input 

Current  cursor  position. 

Bottom  of  File. 

String . 

Direction. 

3.2.1.1.12.2  Output 

Cursor  Position. 

Display  Start  Line. 

3. 2. 1.2  Functionality  of  Command  Mode  Commands 

These  are  accessed  by  pressing  the  <COMMAND>  key  while  in 
the  edit  mode.  The  cursor  then  moves  to  the  command  line.  At 
this  point  you  can  enter  the  command  with  its  operands  and  press 
< ENTER >  or  leave  the  field  blank  and  press  <HELP>  OR  < ENTER > . 
This  second  option  displays  a  menu.  Tou  then  move  the  cursor  to 
the  field  with  the  desired  command,  and  either  type  in  the 
operands  and  press  < ENTER >  or  <KELP>  and  a  form  with  fields  for 
the  operands  is  displayed,  press  < ENTER >  to  enter  this  form. 

The  command  mode  is  exited  by  completing  a  command  or  pressing 
the  <QUIT >  key.  If  the  command  fails,  you  remain  in  the  current 
command  mode  (form,  menu  or  command  line).  In  the  following, 
references  to  the  cursor  position  are  to  the  cursor's  position 
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in  the  buffer  before  the  < COMMAND >  key  was  pressed.  Each 
command  or  operand  is  separated  by  a  blank.  Operands  which 
contain  a  blank  must  be  enclosed  in  double  quotes  (").  On 
successful  completion,  the  message  "operation  complete"  is 
issued.  A  list  of  commands  follows: 

SEARCH 

REPLACE 

LOAD 

SAVE 

CLEAR 

MARGINS 

REPEAT 

BUFFER 

Figure  3-3  shows  the  Command  Menu  you  get  on  pressing 
< ENTER*  to  the  command  line.  A  command's  operands  may  be 
entered  or  a  blank  line.  Entering  a  blank  line  causes  the 
individual  command's  fora  to  be  displayed.  This  form  is 
displayed  at  the  bottom  of  this  form. 


Command  Menu 

Search :  _ 

Replace:  _ 

Load :  _ 

Save :  _ 

Clear:  _ 

Margins:  _ 

Repeat :  _ 

Buffer : 


Figure  3-3  Command  Menu 


3. 2. 1.2.1  Search  for  a  Given  String 
SEARCH  string 

direction  -  Finds  the  first  occurrence  of  the  string 
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after  the  cursor  position  and  positions 
the  cursor  to  the  first  character  of  the 
string  in  the  buffer.  If  the  command  is 
appended  with  a  minus  (e.g.  search 
string  - ) ,  the  search  will  be  done 
‘backwards".  If  the  string  is  not 
found  a  message  is  displayed  and  you 
remain  in  the  current  command  mode.  If 
no  operand  is  supplied  with  search,  the 
last  string  and  direction  searched  for 
is  used. 

A  search  is  not  permitted  on  the  bottom  of  file  mark  or  any 
following  line.  An  attempt  to  do  so  aborts  the  command  and 
issues  a  warning  message. 

Figure  3-4  shows  the  search  for  a  string  form. 


+ - + 

I  I 

i  Command  Menu  i 

i  Search:  i 

l  Replace:  I 

I  Load :  _  I 

l  Save :  _  I 

i  Clear:  i 

l  Margins:  I 

i  Repeat :  _  i 

I  Buffer :  i 


Search  for  a  String 

Enter  String:  _ 

Search  Direction: 


+ - + 


Figure  3-4  Search  for  a  String 


3.2 . 1 .2 . 1 . 1  Input 

Current  Cursor  Position. 

Bottom  of  File. 

String  -  This  is  the  string  to  search  the  TE 

buffer  for.  If  no  string  is  supplied 
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the  last  searched  for  string  will  be 
used. 

Direction  -  The  direction  of  the  search. 

3. 2. 1.2. 1.2  Output 

Cursor  Position. 

Display  start  line. 

3. 2. 1.2. 2  Replace  One  Text  String  with  Another 

REPLACE  “fromstr"  "tostr"  option  direction  -  Finds  the 
first  occurrence  of  the  fromstr  starting  with  the  cursor 
position  and  replaces  it  with  the  tostr.  If  a  star  is  appended 
to  the  command  (e.g.  fromstr  tostr  *),  the  replacements  are  made 
on  all  occurrences  from  the  cursor  to  the  end  of  the  buffer.  If 
a  dot  " . "  is  appended  to  the  command,  the  replacements  are  made 
on  all  occurrences  from  the  cursor  to  the  end  of  the  line.  A 
star  and  a  dot  may  not  be  used  in  the  same  command.  If  a  minus 

is  appended  to  one  of  the  above  commands  the  replacements 
will  be  performed  "backwards".  For  regular  commands  the  first 
occurrence  to  the  left  of  the  cursor  is  replaced.  For  commands 
with  a  dot  all  occurrences  from  the  beginning  of  the  line  to  the 
cursor  are  replaced.  For  commands  with  a  star  all  occurrences 
from  the  top  of  file  to  the  cursor  are  replaced.  If  the  select 
range  is  active,  then  replacements  are  performed  on  all  lines  in 
this  range  and  the  select  mode  is  turned  off.  If  the  fromstr  is 
not  found,  a  message  is  displayed  and  you  remain  in  the  current 
command  mode. 

The  cursor  is  positioned  just  after  the  replaced  text  for 
regular  commands.  For  commands  appended  with  a  dot,  the  cursor 
is  left  at  column  one  of  the  next  line.  For  commands  appended 
with  a  star,  the  cursor  is  positioned  at  the  bottom  of  the  file 
mark  or  at  the  end  of  the  select  range  if  that  form  of  the 
command  is  used.  For  commands  appended  with  a  minus  and  for 
regular  commands,  the  cursor  is  positioned  at  the  left  most 
column  of  the  to  string.  For  commands  appended  with  a  dot,  the 
cursor  is  positioned  at  column  one  of  the  line.  For  commands 
appended  with  a  star,  the  cursor  is  positioned  at  column  one  of 
the  top  of  the  file  line.  A  line  that  is  longer  after  the 
replacement  is  wrapped,  and  a  shorter  line  is  padded  on  the 
right  with  blanks. 

A  replace  is  not  permitted  on  the  bottom  of  file  line  or  any 
following  line.  An  attempt  to  do  so  will  abort  the  command  and 
a  warning  message  is  issued. 
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Figure  3-5  shows  the  replace  string  form. 


Command  Menu 

Search :  _ 

Replace:  _ 

Load.:  _ 

Save :  _ 

Clear:  _ 

Margins:  _ 

Repeat :  _ 

Buffer: 


Replace  One  String  With  Another 

Enter  Old  String:  _ 

Enter  New  String:  _ 

Opt i on :  _ 

Direction: 


Figure  3-5  Replace  String 


3. 2. 1.2. 2.1  Input 


Current  Cursor  Pos 
Bottom  of  File. 
From  string 

To  string 

Opt ion 

Direction 
Select  Mode. 


it  ion . 

This  is  the  text  string  to  be  replaced 
with  the  To  string. 

This  is  the  text  to  replace  each 
occurrence  of  the  From  string, 
blank:  first  occurrence,  dot:  to  end  of 
line,  star:  to  end  of  file, 
blank:  forward,  minus  backward. 


3. 2. 1.2. 2. 2  Output 


Cursor  Position. 
Display  line  start. 


3. 2. 1.2. 3  Load  a  File  for  Editing 


LOAD  file 


The  file  is  inserted  into  the  buffer 
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just  before  the  line  containing  the 
cursor . 

A  load  is  not  permitted  if  the  current  cursor  position  is 
below  the  bottom  of  file  mark.  An  attempt  to  do  so  aborts  the 
command  and  a  warning  message  is  issued.  The  following  I/O 
operations  may  cause  the  command  to  be  aborted  and  a  warning 
message  issued:  Open  file,  Close  file,  and  Read  a  record.  Since 
LOAD  uses  insert  line,  its  failure  causes  the  LOAD  to  be 
aborted. 

In  appendix  A  see  figure  A-27  (before)  and  A-28  (after)  a 

Load . 

Figure  3-6  shows  the  command  form  with  the  load  form. 

+ - + 

i  i 

l  Command  Menu  I 

I  Search :  _  I 

i  Replace:  i 

l  Load :  _  I 

I  Save :  _  i 

i  Clear:  i 

I  Margins:  I 

I  Repeat :  _  I 

l  Buffer :  I 


Load  a  File 
Enter  File  Name: 


+ - + 

Figure  3-6  Load  a  File 


3. 2. 1.2. 3.1  Input 

File  name  -  This  is  the  file  to  be  loaded  for 

editing. 

Current  Cursor  Position. 
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S . 2 . 1 . 2 . 3 . 2  Output 


This  is  moved  so  that  only  lines  above 
the  cursor  position  are  changed. 

Moved  to  the  line  following  the  loaded 
1 ines . 

3. 2. 1.2. 4  Save  the  TE  Buffer 

SAVE  file  -  The  contents  of  the  buffer  are  written 

to  the  file.  If  no  file  name  is 
supplied,  the  buffer  is  written  to  the 
current  buffer  name. 

The  following  I/O  operations  may  cause  the  SAVE  command  to 
be  aborted  and  a  warning  message  issued:  Open  file.  Close  file, 
and  Write  a  record.  The  state  of  the  file  on  such  a  failure  is 
system  dependent.  If  no  file  name  is  supplied  and  there  is  no 
buffer  name,  a  message  is  displayed  and  you  remain  in  the 
current  command  mode. 

Figure  3-7  shows  the  save  the  buffer  to  a  file  form. 


+ - + 

I  I 

I  Command  Menu  i 

l  Search :  _  I 

I  Replace:  I 

l  Load :  _  I 

l  Save :  _  I 

i  Clear:  i 

l  Margins:  l 

I  Repeat :  _  l 

I  Save  a  File  I 

l  l 

I  Enter  File  Name:  _  I 

I  l 

+ - + 


Display  Start 
Line 

Cursor  Position 


Figure  3-7  Save  Buffer 


3. 2. 1.2. 4.1  Input 


File  name 
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This  is  the  name  of  the  file  to  which 
the  contents  of  the  TE  buffer  is 
written.  If  no  file  name  is  given  in 
the  command,  the  buffer's  name  is  used. 


Buffer  name. 
Top  of  File. 
Bottom  of  File 


Clear  the  TE  Buffer 


CLEAR 


l  -  The  buffer  is  cleared  of  text  by 

deleting  all  lines  between  top  of  file 
and  bottom  of  file.  The  lines  replace 
the  contents  of  the  cut  and  paste 
buffer.  Clear  has  no  operands. 

There  are  no  error  conditions  with  this  command. 


Figure  3-8  shows  the  clear  buffer  form. 


Command  Menu 

Search :  _ 

Rep 1 ace :  _ 

Load :  _ 

Save :  _ 

Clear:  _ 

Margins:  _ 

Repeat :  _ 

Buffer:  _ 

Clear  Buffer 

Delete  all  Lines? 


Figure  3-8  Clear  the  Buffer 
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3. 2. 1.2. 5.1  Input 

Top  of  File. 

Bottom  of  File. 

3. 2. 1.2  5.2  Output 

Display  start  line. 

Cursor  position. 

3. 2. 1.2. 6  Set  Limits  of  the  Fill  Margins 

FILL  MARGINS  "left  margin"  “right  margin”  -  Sets  the  left 
and  right  margins  for  the  <FILL>  key.  The  margin  values  must 
satisfy  the  following  constraint: 


"left  margin"  <  “right  margin* 


display  size  +  1 . 


If  the  above  constraint  is  not  satisfied,  the  command  is 
aborted  and  a  warning  message  is  issued. 

Figure  3-9  shows  the  Set  Fill  Margins  form. 


I  Command  Menu  I 

I  Search:  I 

I  Replace:  I 

I  Load :  _  I 

l  Save :  _  l 

l  Clear:  I 

l  Margins:  I 

I  Repeat :  _  I 

I  Buffer:  I 

I  I 

I  Set  Fill  Margins  I 

I  Left  Margin:  _  I 

I  Right  Margin:  _  i 

I  I 

+ - + 

Figure  3-9  Set  Fill  Margins 


3. 2. 1.2. 6.1  Input 


Left  margin 
Right  margin 
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-  The  left  margin  extends  from  zero  to 
this  number. 

-  The  right  margin  extends  from  this  value 
to  the  display  size  plus  one. 


3. 2. 1.2. 7  Repetition  of  a  Command 


REPEAT  number 


This  allows  some  function  keys  and  all 
commands  to  be  repeated  number  times. 
Upon  entering  this  command,  the  message 
“in  repeat**  is  displayed.  Enter  the 
command  or  press  the  function  key  which 
is  to  be  repeated.  The  function  keys 
which  are  supported  include: 

< INSERT  LINE > ,  < DELETE  LINE > ,  < PASTE » , 
and  <FILL> .  The  < FIRST  PAGE> ,  < LAST 
PAGE >  and  <QUIT>  keys  are  executed  only 
once. 


The  number  of  repetitions  must  be  greater  than  zero.  If 
not,  the  function  is  aborted  and  a  warning  message  is  issued. 

Figure  3-10  shows  the  Repeat  Command/Function  form. 


Command  Menu 

Search:  _ 

Replace:  _ 

Load :  _ 

Save :  _ 

Clear:  _ 

Margins:  _ 

Repeat :  _ 

Buffer:  _ 

Repeat  Command /Function 
Enter  Repeat :  _ 


Figure  3-10  Repeat  Command/Function 
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3. 2. 1.2. 7.1  Input 
Number 
Command 


This  is  the  number  of  times  the  command 
is  repeated. 

This  is  the  command  to  execute  number 
times . 


Other  inputs  to  this  command  are  determined  by  the  repeated 
command. 


3. 2. 1.2. 7. 2  Output 

Outputs  of  this  command  are  determined  by  the  repeated 
command . 


3. 2. 1.2. 8  Name  the  Buffer 

Buffer  " f i 1 ename “ -  This  becomes  the  default  name  for  a  save 

command. 

There  are  no  error  conditions  associated  with  this 

command . 

Figure  3-11  shows  the  name  the  buffer  form. 


+ - + 

i  i 

i  Command  Menu  i 

i  Search:  i 

I  Replace:  l 

l  Load :  _  l 

I  Save :  _  i 

l  Clear:  I 

I  Margins:  i 

I  Repeat :  _  I 

i  Buffer:  I 


Buffer  Name 
Enter  Buffer  Name: 


+ - + 


Figure  3-11  Name  Buffer 
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3. 2. 1.2. 8.1  Output 
Buffer  name. 

3.2.2  ITEM  Editing  in  the  Form  Processor  Mode 

The  purpose  of  ITEM  Editing  is  to  facilitate  moving, 
copying,  deleting  and  substituting  text  among  ITEMS.  The  FP/TE 
understands  the  structure  of  forms  sufficiently  to  allow  this  to 
be  done  in  a  friendly  manner.  ITEM  editing  is  a  submode  of  the 
FP.  You  enter  the  FP/TE  by  pressing  the  FP  <MODE>  key  until  the 
"text  edit"  choice  appears  in  the  mode  field.  You  return  to  the 
application  by  pressing  the  <MODE>  key  until  the  "application" 
choice  appears  in  the  mode  field.  All  functions  and  commands 
work  with  ITEMS  only  so  the  cursor  must  be  within  an  ITEM  when 
they  are  issued.  The  VT  functions  which  are  exceptions  are 
noted. 


Error  handling  is  listed  under  each  function.  In  general 
an  error  causes  the  function  to  be  aborted  and  a  warning  message 
to  be  issued.  If  the  cursor  is  not  in  an  ITEM  when  a  function 
or  command  is  issued,  the  command  is  aborted  and  a  warning 
message  issued. 

3.2.2. 1  Commands  Implemented  Through  Keys 

The  following  is  a  list  of  functions  which  are  implemented 
through  the  VT.  The  VT  functions  which  are  usable  outside  of  an 
ITEM  are  marked  with  a  star 


<UP  ARROW >* 

<  DOWN  ARROW >* 

<LEFT  ARROW >* 

< RIGHT  ARROW >  » 

<  TAB  >  * 

<  BACK  TAB>  * 

< DELETE  CHARACTER >- 


Move  cursor  up  one  line. 

Move  cursor  down  one  line. 

Move  cursor  left  one  character. 

Move  cursor  right  one  character. 

Moves  cursor  to  the  next  input  ITEM. 

Moves  cursor  to  the  previous  input  ITEM. 

Shift  left  one  character  the  characters 
from  just  right  of  the  cursor  to  the  end 
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of  the  field  line.  The  right  most 
character  in  the  field  line  is  replaced 
with  a  blank. 

< INSERT  CHARACTER>-  Shift  right  one  character  the  character 

from  the  cursor  position  to  the  end  of 
the  field  line.  The  right  most 
character  in  the  field  is  lost  and  the 
character  at  the  cursor  position  is 
replaced  with  a  blank. 

3. 2. 2. 1.1  Scrolling.  Paging.  First  and  Last  Page 

The  scroll  and  page  keys  refer  to  arrays  and  not  an 
individual  ITEM.  See  the  Terminal  Operator's  Guide  for  their 
use  in  applications. 

3. 2. 2. 1.2  ITEM  Insert  Line 

< INSERT  LINE>  -  Move  down  one  line  the  line  containing 

the  cursor  and  all  following  lines  in 
the  ITEM.  The  last  line  becomes  a  saved 
line.  A  saved  line  is  a  line  pushed  off 
the  bottom  of  an  ITEM.  They  are  not 
part  of  the  data  available  to  the  FP  or 
applications  and  are  kept  only  as 
long  as  the  FP  is  in  the  text  edit  mode 
and  the  cursor  remains  in  the  same  ITEM. 
They  would  be  used  in  the  following 
manner:  user  inserts  a  line  to  add  some 
data  which  does  not  fill  the  entire 
line,  then  deletes  the  entire  item  and 
pastes  it  back  with  fill  reformatting 
the  item  with  the  new  data.  The  line 
with  the  cursor  is  filled  with  blanks. 

There  are  no  error  conditions  with  this  function. 

3. 2. 2. 1.2.1  Input 

Current  cursor  position. 

Field  pointer. 

3. 2. 2. 1.3  ITEM  Midline  Break 

< MIDLINE  BREAK)  -  All  characters  from  the  cursor  position 

to  the  end  of  the  line  are  removed  and 
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inserted  at  the  beginning  of  a  newline 
within  the  ITEM  immediately  following 
the  cursor's  line.  The  last  line 
becomes  a  saved  line. 

There  are  no  error  conditions  with  this  function. 

3.2.2. 1 .3. 1  Input 

Current  cursor  position. 

Field  pointer. 

3. 2. 2. 1.3. 2  Output 

Cursor  position. 

3. 2. 2. 1.4  Previous  Contents  Restore 

« PREVIOUS  CONTENTS >  -  The  contents  of  the  ITEM  which 

contains  the  cursor  are  replaced  with 
the  contents  it  held  before  the  last 
application  function  key  was 
pressed. 

3.2.2. 1 .4. 1  Input 

Current  cursor  position. 

Field  pointer. 

3. 2. 2. 1.5  Cut  and  Paste  Scenario  for  ITEM  Editing 

This  is  somewhat  different  from  file  editing.  A  sequence 
of  delete  lines  or  one  delete  entire  ITEM  replaces  the  contents 
of  the  cut  and  paste  buffer.  The  lines  may  be  inserted  into  am 
ITEM  exactly  as  they  were  deleted  using  <PASTE>.  In  this  case 
if  the  original  lines  were  longer,  they  are  truncated;  if 
shorter,  they  are  padded  on  the  right  with  blanks.  If  there  are 
more  lines  in  the  cut  and  paste  buffer  than  lines  in  the 
receiving  ITEM,  then  the  extra  lines  become  part  of  the  target 
ITEM ' S  saved  lines. 

The  lines  may  be  reformatted  and  inserted  into  an  ITEM 
using  <FILL>.  The  lines  are  reformatted  so  that  as  many  whole 
words  as  possible  fit  on  each  line  of  the  item.  If  a  word  is 
too  wide  to  fit  on  a  line  of  the  receiving  ITEM,  it  is  wrapped. 
If  a  line  inserted  by  a  fill  does  not  completely  fill  a  line  of 
the  ITEM,  it  is  padded  on  the  right  with  blanks.  If  there  are 
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■ore  words  in  the  cut  and  paste  buffer  than  will  fit  in  the 

ITEM,  the  extra  become  part  of  the  target  ITEM'S  saved  lines. 

3. 2. 2. 1.5.1  ITEM  Delete  Line 

<DELETE  LINE >  -  The  characters  from  the  cursor  position 

to  the  end  of  the  line  in  the  ITEM  are 
deleted.  If  the  cursor  is  at  the  first 
position  of  the  line  in  the  ITEM,  move 
up  one  line  the  lines  following  the  line 
containing  the  cursor  and  fill  in  the 
last  line  in  the  field  with  a  saved  line 
or  if  none  are  left,  with  blanks.  (see 
insert  line  for  a  description  of  saved 
lines).  Else  the  cursor  is  moved  to  the 
first  position  of  the  line  in  the  ITEM 
following  the  current  line.  If  the  user 
has  not  moved  the  cursor  since  the  last 
(DELETE  LINE >  the  characters  are 
concatenated  to  the  cut  and  paste 
buffer.  Else  they  replace  it. 

There  are  no  error  conditions  with  this  function. 

3. 2. 2. 1.5. 1.1  Input 

Current  cursor 

position  -  This  is  the  position  within  the  ITEM. 

Field  pointer  -  This  is  a  pointer  to  the  ITEM  containing 

the  cursor. 

3.2 .2 . 1 . 5 . 1 .2  Output 

Cut  and  paste  buffer . 

Cursor  position  -  If  the  cursor  is  at  the  first  position 

of  a  line  in  an  ITEM,  it  is  not  moved; 
else  it  is  moved  to  the  first  position 
of  the  line  in  the  ITEM  following  the 
current  line. 

3. 2. 2. 1.5. 2  Delete  Entire  ITEM 

(DELETE  ENTIRE  ITEM > -  Each  line  of  the  ITEM  containing  the 

cursor  and  the  ITEM'S  saved  lines  are 
deleted  and  replaced  with  blanks.  The 
lines  of  the  ITEM  replace  the  contents 
of  the  cut  and  paste  buffer. 
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There  are  no  error  conditions  with  this  function. 

3.2.2. 1 .5.2. 1  Input 

Current  cursor  position. 

Field  pointer. 

3.2.2. 1 .5.2.2  Output 

Cut  and  paste  buffer. 

Cursor  position. 

3 . 2 . 2 . 1 . 5 . 3  Paste  for  Cut  and  Paste 

< PASTE*  -  This  inserts  the  contents  of  the  cut  and 

paste  buffer  at  the  cursor  position 
within  an  ITEM. 

There  are  no  error  conditions  with  this  function. 

3. 2. 2. 1.5. 3.1  Input 

Current  cursor  position. 

Field  pointer. 

Cut  and  paste  buffer. 

3. 2. 2. 1.5. 4  Fill  for  Cut  and  Paste 

<FILL>  -  This  formats  the  contents  of  the  cut  and 

paste  buffer  so  that  as  many  whole  words 
as  possible  can  be  inserted  on  each  line 
of  the  ITEM  containing  the  cursor.  Fill 
margins  may  be  set  for  an  ITEM  and  are 
in  effect  for  the  fill  that  follows  as 
long  as  the  cursor  remains  in  the  ITEM 
in  which  the  margins  were  set. 

There  are  no  error  conditions  with  this  function. 

3 .2 .2 . 1 . 5 .4 . 1  Input 

Current  cursor  position. 

Field  pointer. 

Cut  and  paste  buffer. 
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3. 2. 2. 1.6  Item  Search 

< SEARCH >  -  The  ITEM  containing  the  cursor  is 

searched  for  the  first  occurrence  of  the 
string  after  the  cursor,  and  the  cursor 
is  positioned  at  this  occurrence.  If 
the  command  is  appended  with  a  minus 

the  search  is  done  “backwards".  If 
the  string  is  not  found  in  the  ITEM,  a 
message  is  displayed,  and  the  cursor 
position  is  unchanged. 

The  following  prompts  are  displayed: 

Search  String:  Direction 


3.2.2. 1 .6. 1  Input 

Current  cursor  position. 

Field  pointer. 

string  -  The  string  to  search  the  ITEM  for. 

Direction  -  Blank:  forward,  minus:  backward. 

3. 2. 2. 1.6. 2  Output 
Cursor  position. 

3. 2. 2. 1.7  ITEM  Search  Next 

<SEARCH  NEXT>  -  This  is  equivalent  to  issuing  the 

SEARCH  command  with  no  operands;  that 
is,  it  repeats  the  last  search. 

The  error  conditions  are  the  same  as  for  the  SEARCH 
command . 

3.2.2. 1 .7. 1  Input 

Current  Cursor  Position 
Field  Pointer 

String  -  The  last  string  used  in  a  search. 

Direction  -  The  last  direction  used  in  a  search. 

3. 2. 2. 1.7. 2  Output 


Cursor  Position. 
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3. 2. 2. 1.8  Item  Replace 

< REPLACE >  -  Immediately  after  a  search  or  search 

next,  a  replace  may  be  done  to  replace 
the  just  searched  for  string  with  the 
replacement  string. 

The  following  prompts  are  displayed: 

Replacement  String:  Direction: 

3.2.2. 1 .8 . 1  Input 

Current  cursor  position. 

Field  pointer. 

String  -  The  text  string  replacing  the  search  string. 

Direction  -  Blank:  forward,  minus:  backwards. 

3. 2. 2. 1.8. 2  Output 
Cursor  position. 

3. 2. 2. 1.9  Replace  Next 

< REPLACE  NEXT>  -  May  be  used  immediately  after  a  search. 

It  repeats  the  most  recently  executed 
replace . 

The  error  conditions  are  the  same  as  for  the  < REPLACE > 
function . 

3. 2. 2. 1.9.1  Input 

Current  Cursor  Position. 

Field  Pointer. 

String . 

Direction . 

3. 2. 2. 1.9. 2  Output 
Cursor  Position 

3.2.2.1.10  ITEM  -  Set  limits  of  the  fill  margins. 

< MARGINS >  -  Sets  the  fill  margins  for  the  ITEM 

containing  the  cursor.  The  margins  are 


3-32 


DS  620144600B 
1  November  1985 


In  effect  for  as  long  as  the  cursor  is 
within  the  sane  ITEM. 

The  following  pronpts  are  displayed: 

Fill  Margins  -  Left:  Right: 

3.2.2.1.10.1  Input 

left  margin. 

right  margin. 

3.2.2.1.11  Item  Repeat 

< REPEAT>  -  The  next  command  or  function  key  is 

executed  number  times  within  the  ITEM 
containing  the  cursor.  The  command  is 
similar  to  the  file  editing  version. 

The  following  functions  are  supported: 

< INSERT  LINE>  < MIDLINE  BREAK > , 

< PASTE >,  <FILL>,  < DELETE  LINE> ,  and 
<QUIT> . 

The  number  must  be  greater  than  zero.  If  not,  the  command 

is  aborted  and  a  warning  message  is  issued. 

The  following  prompt  is  displayed: 

Repeat  count : 

3.2.2.1.11.1  Input 

Current  cursor  position. 

Field  pointer. 

number  -  The  number  of  times  the  command  or 

function  is  the  be  executed. 

function  key  -  This  is  the  item  to  be  repeated. 

3.2.2.1.11.2  Output 

This  is  dependent  on  the  command  or  function  repeated. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4 . 1  Introduction  and  Definitions 

“Testing”  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance  and  a  sequence  of  test  steps  may  be 
specified.  “Debugging”  is  the  process  of  isolation  and 
correction  of  the  cause  of  and  error. 

4.2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  will  be  performed  by  the  design  team. 

The  integration  test  developed  for  the  TE  consists  of  a 
list  of  commands  (and  their  expected  outputs)  which  are  used  to 
create  a  script  output  of  a  test  session  and  its  output.  This 
session  tests  each  function  and  command  to  ensure  its  correct 
operation.  Results  of  the  session  may  be  compared  with  those  of 
the  unit  testing. 

Because  the  TE  consists  of  a  flat  hierarchy  of  modules, 
unit  testing  primarily  involves  testing  each  of  the  TE  interface 
routines  and  internal  functions  for  correct  processing  and 
output . 

Below  the  level  of  modules  implementing  each 
function /command  is  a  small  set  of  procedures  for  assuring  the 
integrity  of  the  buffer  and  the  top  of  file,  bottom  of  file, 
cursor  position  and  display  start  line.  Since  the  TE  is 
actually  an  FP  application,  each  reference  to  an  FP  procedure  is 
verified  that  it  contains  the  correct  parameters  and  each  form 
is  displayed  to  ensure  it  is  correct. 

The  test  developed  for  the  FPTE  is  similar  to  the  TE. 
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SECTION  5 

PREPARATION  FOR  DELIVERY 


The  implementation  site  for  the  constructed  software  is  the 
Integrated  Support  System  (IISS)  Test  Bed  site  located  at  the 
General  Electric  Company,  in  Albany,  NY.  The  Software 
associated  with  each  TE  release  is  clearly  identified  and 
includes  instructions  on  procedures  to  be  followed  for 
installation  of  the  release. 
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APPENDIX  A 

FIGURES  OF  BEFORE  AND  AFTER  AN  OPERATION 

In  all  figures  the  designation  in  parenthesis  refers  to  the 
paragraph  in  section  3  and  the  cursor  is  indicated  by  a  box. 
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Figure  A- 1  Screen  Before  Delete  Line  (3.2.1 .1 .10. 2. a.) 


2 


DS  620144600B 
1  November  1985 


|  O |  applcatton 


Figure  A-3  Screen  Before  Insert  Line  (3. 2. 1.1. 8. a) 
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•includa  <etdtyp.h> 
•include  (etdio.h) 

•  include  ifpd.h) 

P 

•include  <fpcode.h> 
•Include  (fppere.h) 


•define 
•define 
•define 
•define 
•def lne 
•define 
•define 
•define 
•define 
•define 
•define 
•define 
•define 
•define 
■define 


RCODE_LEN  S 
ENTER  0 

CHOKE  V  S 

FIRSTPAGE  7 
LASTPAGE  B 
INSERTLINE  9 
DECLINE  10 
YANK  11 

FILL  12 

MIDLINE  13 
SELECT  14 
SEARCH  16 
0SP_HE I GHT  22 
DSP_NIDTH  79 
ACT_HE I GHT  23 


)  > 


Meg:  [~o] 


•pp  l cat  Ion 


Figure  A -4  After  Insert  Line  (3.2. 1 . 1 .8 .b") 


A-5 


DS  6201 44600 B 
1  November  1985 


•include  l(tdtyp.h) 
•include  <etdio.h> 
nclude  <fpd.h> 


•include  <fpcode.h> 
•  include  (fppe-a.h) 


•define  RCODE_LEN  3 


•define  ENTER 


•define  CMDNEV 


•define  FIRSTPAGE  7 


•define  LASTPAGE  B 


•define  INSERTLINE  9 


•define  DEL LI ME  10 


•define  YANK 


•define  FILL 


•define  MIDLINE  13 


•define  SELECT  14 


•define  SEARCH  Id 


•define  DSPHE I GHT  22 
•define  D8PJMIDTH  79 
•define  ACT_HEIGHT  23 


«»S:  [  0  | 


applcat ion 


Figure  A-5  Before  Next  Line  Command  -  scroll  up  3. 2. 1.1. 2. a 


•  Include  <stdtyp.h> 
•include  (ltdio.h) 
•include  ifpd.H) 

3 

•include  (Opcode. n> 
•include  ifppara.hl 

•define  RCODEJLEN  S 
•define  ENTER  0 
•define  CHOKE Y  S 
•define  FIRSTPAGE  7 
•define  LASTPAGE  8 
•define  INSERTLINE  9 
•define  OELLINE  10 
•define  YANK  11 
•define  FILL  12 
•define  HIDLINE  13 
•define  SELECT  14 
•define  SEARCH  16 
•define  DSP_HE I GHT  22 
•define  OSP_WIDTH  79 
•define  ACT_HEIGHT  23 
>> 

H.s:  jj[] 


•pplcat ion 
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Line  Command  -  scroll  down 
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•include  (stdtyp.h) 
•include  Otdio.hl 
•include  (Ipd.h) 

3 

•include  (Opcode. h> 
•include  <fppere.h> 

•define  RCOOC_LEN  S 
•define  ENTER  0 

•define  CHDKEY  3 
•define  FIRSTPAGE  7 
•define  LASTPAI3E  8 
•define  INSERTLINE  9 
•define  DELLXNE  10 
•define  YANK  11 
•define  PILL  12 

•  define  PIIDLINE  13 
•define  SELECT  14 
•define  SEARCH  16 
•define  OSP_HEIGHT  22 
•define  D8P_NJDTH  79 

•  define  ACT _ME I GHT  23 

>> 


nmg:  [~o] 


•pp l cat  ton 


Figure  A-9  Before  Next  Page  -  page  up  (3.2. 1 . 1 .4. a) 
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•datins  ACT.HEIOHT  23 
•datina  ACT_H!DTH  BO 
Sdafina  CNDJLEN  41 


static  Int  dsp_ht  •  D8P_HEIBHT.  dap_«d  *  D8P_M!DTHI 
static  lnt  act_ht  -  ACT_HEIQHT.  act_Md  «  ftCT_WIDTHl 
static  lnt  currant  ■  CURRNT ■  previous  ■  PREVi 


static  int  para  ■  PERTH 


static  lnt 


static  char  blanfcsCACT_MlDTH»13l  /•  a  string  of  blanks  •/ 


typadat  struct  taxt_l  ins  < 


struct  taxt_lina  *naxt  •  apravl 


1 inal ACT  WIDTH* 1 1 1 


>  TEXT_HNE« 


static  TEXTJLINE  •traa_list  «  NULL.  *gatnoda()i 


static  TEXTJ.INE  linaCdl 


tlinaCll.  NULL. 


NULL.  Ill ineCOl .  -\0" 


Msg:  |  Q| 


scr 1 1/paga 


Figure  A-10  After  Next  Page  -  page  up  (3.2. 1 . 1 .4.b) 


A-l  1 


'  V  S  % 


Sdafina  ACT_HEI0HT  23 
Sdof  ir>a  ACTJHIDTM  BO 
Sdafina  CMD_LEN  41 


static  lnt  dsp_ht  -  DSP_HEI8HT.  dmp_md  -  DBP_NIDTHI 

static  lnt  aet_ht  -  ACT_HE10HT .  act_Md  ■  ACT_JMDTHI 

static  int  currant  »  CURRNT ,  previous  ■  PftEVI 
static  int  pal-in  m  PERM! 

static  lnt  taap  m  TEMPI 

static  char  blanfcsC ACT_NIDTH*1 1 »  /•  a  string  of  blanks  •/ 

typadaf  struct  tSKt_lina  < 

struct  taxt_lina  *naxt .  apravi 
Char  linaCACT_WlDTH+ns 
>  TEXT_LINE: 

static  TEXT_LINE  •fraa_l»st  -  NULL.  agatnodaOl 


static  TEXT_LINE  linaldJ  ■ 

I>1  insC  II.  NULL.  *\0". 

I  NULL.  HinsCOJ.  "\0". 


> ) 

Msg:  [~o~| 


scr 1 1/paga 
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•include  <stdtyp.h> 
•Include  istdio.h) 
•Include  <fpd.h> 

1 

•Include  (Opcode. h> 
•Include  <fppare.h> 


•define 

RCOOE_LEN  3 

•define 

ENTER 

0 

•define 

CKWEY 

3 

•define 

FIRSTPAGE  7 

•def  ine 

LAS  TP  AGE 

e 

■define 

INSERTLINE  9 

•define 

DEL LINE 

10 

•define 

YANK 

u 

•define 

FILL 

12 

•define 

MIDLINE 

13 

•define 

SELECT 

14 

• 

c 

•e* 

1 

• 

SEARCH 

16 

•define 

DSP_HE  I GHT  22 

•define 

DSP_WIDTH  79 

•define 

ACT_HEIGHT  23 

)> 

Msg:  |  0[  scr 1 1/page 


Figure  A-12  After  Previous  Page  -  page  down  (3 -2. 1.1. 5 
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•includa  <mtdtyp.h> 

•Includa  (atdlo.h) 

•  includa  <lpd.h> 

J 

•  includa  (ipcodo.h) 

•  includa  (ippar«.h) 

•dal ina  RCOOE_LEN  3 
•dal ina  ENTER  0 

•dal ina  CMDKEY  3 

•dal ina  FIRSTRAGE  7 
•dal ina  LAS TP AGE  8 
•dal ina  INSERTLINE  9 
•dal ina  DELLINE  lO 
•dal ina  yank  ll 

•dal ina  FILL  12 

•dal ina  MIDLINE  13 
•dal ina  SELECT  14 
•dal ina  SEARCH  16 
•dal ina  DSP_HEIGHT  22 

•  Oaf ina  D8P_UIDTH  79 
•dal ina  ACTHE1GHT  23 

>  > 

Mag:  |  0  |  mcrll/paga 


Figure  A-13 


Before  First  Page  (3.2. 1 . 1 .6.a) 
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Figure  A-14  After  First  Page  (3.2. 1 . 1 .6.b) 
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/•  NAME 

•  £01  TCI  -  EDIT  Callable  Interface 

•  I#* *  It  ten:  23-0CT-19B4  12:58:20  -  8CO-ANDORF 

•  Revised:  B-APR-19B3  09:56:15  -  8DRC 

• 

•  SYNOPSIS 

•  bool  EDITCItfile.  changed) 

•  char  f  \  let  3  t 

•  int  ^changed! 

• 

•  Input*: 

•  file  -  character  string  with  name  of  file  to  be  edited.  Length 

•  is  30.  String  must  be  blank  filled  in  all  languages  except  C. 

• 

•  Outputs: 

•  changed  -  pointer-  to  flag  indicating  that  the  file  was  changed. 

• 

•  description 

This  start*  up  the  editor-.  It  is  the  entry  point  if  called  from  a 
program.  Return*  TRUE  if  the  file  ha*  been  changed  else  FALSE. 

Initializes  the  three  buffer*,  puts  up  the  editing  form,  if  specified 
it  reads  in  a  file  and  starts  the  editing  loop. 


)  > 

h*g:  |  1  | Top  of  File 


app lcat l on 
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< 

j  i  -  01 

wftil*  <c«d_Ur>aC13  —  '  M 

If  (c»d_I inaC i 3  !-  •\0*) 

< 

If  <ciad_l  InaC  t  3 

Mhila  (c<*d_lln«C i 3  >  •  •> 

dataCj  3CJ  l«-»3  -  cmd_l InaC  1++3I 

•  Is* 

< 

!♦+» 

while  ( cmd_l i na C i 3  ' ■  bt<  c*d_l inaC  i  3  !»  •  \0’ > 
dataCj  3 C  j  l»-*3  “  cmd_l  inaC  i*-»3l 
If  (cmd_l inat i 3  !“  ’SO*)  i+»t 
> 

nundat 

> 

dataC j 3 1 j 13  ■  • \0’ i 
> 

> 

)  >  >  >buf  _baf  <  <  <  < 

— - 

nag:  |  l  jBottoa  of  fila  applcatlon 


Figure  A-16  After  Last  Page  (3.2.1 .1 .7. b) 
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CD! TCI  -  EDIT  Callable  Interface 

Written:  23-0CT-1484  12:98:20  -  8C0LANDORF 
Revised:  S-APR-1489  04:94:19  -  BDRC 


SYNOPSIS 

bool  EDI  TCI (♦lie.  changed) 


char  filed* 


lnt  schangedi 


>  >  >  >  SELECT  LINE<<<<<<< 


Inputs: 

tile  -  character  string  with  naae  of  file  to  be  edited.  Length 

is  30.  String  eust  be  blank  filled  in  all  languages  except  C. 


changed  -  pointer  to  flag  indicating  that  the  file  "as  changed. 


DESCRIPTION 

This  starts  up  ths  editor.  It  is  the  entry  point  if  called  fro*  a 
prograe.  Ratty  ns  TRUE  if  the  file  has  been  changed  else  FALSE. 
Initializes  the  three  buffers,  puts  up  the  editing  fore,  if  specified 


hsg:  [Tj 


Select  active 


applcat ion 


Figure  A-21  Positioning  Cursor  for  Delete  for  Cut  and  Paste 
(3. 2. 1.1. 10. c) 
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NAME 

EDI TCI  -  EDIT  Cal  labia  Interface 

Written:  23-0CT-1984  12:38:20  -  SCQLANOORF 
Revised:  8- APR - 1 90S  09:56: 13  -  6DRC 

SYNOPSIS 

bool  EDlTCIifila.  changed) 
char  filet  11 
lnt  •changed) 


Outputs: 

changed  -  pointer  to  flag  indicating  that  the  file  Mas  changed. 


DESCRIPTION 

This  starts  up  the  editor.  It  is  the  entry  point  if  called  from  a 
program.  Returns  TRUE  if  the  file  has  been  changed  else  FALSE. 
Initializes  the  three  buffers,  puts  up  the  editing  form,  if  specified 
it  reads  in  a  file  and  starts  the  editing  loop. 


•  DESCRIPTION 


) ) 


hsg:  |  O  | 


applcat ion 


Figure  A-22  After  Hitting  Delete  Line  for  Cut  and  Paste 

(5. 2. 1.1. 10. d) 
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klAMC 

CD I TCI  -  EDIT  Cal  labia  Intarfaca 

Mrittan:  23-0CT-1984  12158:20  -  BC8LANDORF 
Ravi sad:  B-APR-I983  04:3*: 15  -  BDRC 

synopsis 

bool  EDITCIlfila.  changed) 
char  fllatll 
lnt  ‘changed t 


Outputs: 
chan gad 


polntar  to  flag  indicating  that  tha  file  mss  chan gad. 


DESCRIPTION 

This  starts  up  tha  aditor.  It  la  tha  entry  point  if  cal  lad  from  a 
program.  Raturns  TRUE  if  tha  fila  has  baan  changad  alaa  FALSE. 
Initialixas  tha  thraa  buffars*  puts  up  tha  adltlng  form,  if  apacifiad 
it  raads  in  a  fila  and  starts  tha  adltlng  loop. 

• 

•  DESCRIPTION 


>  > 


(tag:  [~o] 


applcat ion 


Figure  A-23  Before  Paste  of  Cut  Buffer  (3.2 . 1 . 1 . 10. S.a) 
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IhvlMd:  8-APR-1985  09:56:15  -  BDftC 

SYNOPSIS 

bool  EDITCIiflls.  changed) 
char  ftlslli 
lnt  achangsdl 

Inputs: 

fils  -  charactsr  string  with  ns  as  of  fils  to  bs  sditsd.  Lsngth 

is  30.  String  oust  bs  blank  fillsd  in  all  languagss  sxcspt  C. 

Outputs: 

changsd  -  pointsr  to  flag  indicating  that  ths  fils  was  changsd. 
DESCRIPTION 

This  starts  up  ths  sditor.  It  is  ths  sntry  point  if  callsd  from  a 
program.  Rst urns  TRUE  if  ths  fils  has  bssn  changsd  slss  PAUSE. 

Initializss  ths  thrss  buffsrs.  puts  up  ths  sditing  form,  if  spscifisd 
it  rsads  in  a  fils  and  starts  ths  sditing  loop. 

• 

•  DESCRIPTION 


>) 

Msg:  [IT] 


•pplcct l on 


Figure  A-24  After  Paste  of  Cut  Buffer  (3.2. 1 . 1 . 10.3. b) 
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isad:  S-APR-19B3  09:36:19  -  3DRC 


SYNOPSIS 

bool  EDITCl(4ils.  ch«nfid) 
char  HltUl 
int  (changad; 


•  4lla  -  character  string  with  naa*  of  411*  to  ba  ddltad.  Langth 

•  la  30.  String  oust  ba  blank  fillad  in  all  languagas  axcapt  C. 

• 

•  Outputs: 

•  changad  -  pointer  to  flag  indicating  that  tha  411a  was  changad. 

• 

•  DESCRIPTION 

This  starts  up  tha  aditor.  It  is  tha  antry  point  14  callad  from  a 
prograa.  Rat  urns  TRUE  i4  tha  4ila  has  baan  changad  alsa  FALSE . 

Initial! zai  tha  thraa  bu44ars.  puts  up  tha  aditing  form,  14  spacl4iad 
it  raads  in  a  4ila  and  starts  tha  aditing  loop. 

• 

•  description 


fsg:  [  o  | 


app lcftt ion 


Figure  A-25  Before  Fill  of  Cut  Buffer  -  margins  changed  to  40 
70  (3. 2. 1.1. 10. 4. a) 


f 

* 

V 


int  achangadi 
Inputs: 

tils  -  charactar  string  with  nsss  s<  fils  to  bs  sditsd.  Lsngth 

is  30.  String  sust  bs  blank  fillsd  In  all  languagss  txcvpt  C. 

•  Inputs:  *  fils  -  charactsr 
string  with  nans  of  fils  to 
bs  sditsd.  Lsngth  •  is  30. 

String  Bust  bs  blank  fillad 
in  all  languagss  sscspt  C. 


■  L 


•  Outputs: 

•  changsd  -  pointsr  to  flag  indicat  ing  that  ths  fils  Mas  changsd. 

• 

•  DESCRIPTION 

This  starts  up  ths  sdltor.  It  is  ths  sntry  point  if  cal  lad  fro*  a 
prograa.  Rat  urns  TRUE  if  tha  fils  has  bsan  changsd  alsa  FALSE. 
Initialiiaa  tha  thraa  buffsrs.  puts  up  tha  sditing  fora,  if  apacifiad 
it  rsads  in  a  fils  and  starts  ths  sditing  loop. 


•  DESCRIPTION 
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For  mm  Procnw r  Text  Editor.  Provides  text  editing  capability  for 
lias  mvlrrant. 

Tha  TE's  nodule  hierarchy  la  rathar  flat.  In  general  there  is  one 
aodule  which  lap  lament*  each  function  or  coaaand.  These  aodules  are 
(uet  below  the  Initialisation  and  edit  loop.  Under  these  are  a  sea  1 1 
nuaber  of  routines  which  per  fora  pointer  maintenance  and  other  house 
keeping  functions. 

Primary  data  structure  consists  of  three  buffers.  These  buffers  are 
doubly  linked  lists  with  a  haader  and  trailer  node.  These  two  nodes 
are  pointed  to  by  x_tof  and  x_bof  respectively,  where  x  is  the  name 
of  the  buffer.  The  node  structure  is  denoted  by  the  struct 
"TEXT_LINE".  The  aain  buffer  containing  the  file  being  edited  has 
several  other  pointers  which  indicate  the  first  line  to  be  displayed, 
the  line  containing  the  cursor  and  a  line  which  is  a  terminus  of  the 
select  range. 

buf  -  Buffer  which  contains  the  contents  of  the  file  being  edited. 
buf_tof  -  A  pointer  to  the  buf's  header  node. 
buf_bof  -  A  pointer  to  the  buf's  trailer  node. 


>  > 

nsg:  [~o] 


scr  1 1/page 
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Figure  A-28  After  Load  File  (3.2. 1 .2.3. b) 


A-29 


APPENDIX  B 


CUT  AND  PASTE  SCENARIO 


The  following  figures  illustrate  the  operation  of  selecting 
a  region  of  text  to  cut  and  then  paste  without  and  with  fill. 

The  figures  are  in  reference  to  section  3.2.1.1.10. 


B-l  Before  Select  for  Cut  and  Paste 
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•  J uat  below  the  initialization  and  adit  loop.  Undar  thaaa  ara  a  aaall 

•  nuabar  of  rout  inea  which  per  fore  po intar  waintenance  and  othar  houaa 

•  keeping  functiona. 

•  Primary  data  atructura  canaiata  of  thraa  buffer*.  Thaaa  buffera  ara 

•  doubly  1  ink ad  1 i at  a  with  a  haadar  and  trailar  noda.  Thaaa  tao  nodaa 

•  ara  polntad  to  by  «_to<  and  K_dof  raapact ivaly.  ahara  k  la  tha  naaa 

•  of  tha  buffer.  Tha  noda  atructura  la  danotad  by  tha  atruct 

•  *TEXT_LINE".  Tha  aain  buffer  containing  tha  file  baing  aditad  haa 

•  aavaral  othar  pointara  which  tndicata  tha  firat  lina  to  bo  diaplayed. 

•  tha  lina  containing  tha  curaor  and  a  lina  which  ta  a  t or a i nua  of  tha 

•  aalact  ran go. 

•  buf  -  Buffer  which  containa  tha  contanta  of  tha  fila  baing  aditad. 

•  buf_tof  -  A  pointar  to  tha  buf'a  haadar  noda. 

•  buf_bof  -  A  pointar  to  tha  buf'a  trailar  noda. 

•  cir_row  -  A  pointar  to  tha  lina  containing  tha  curaor. 

•  buf_atart  -  A  pointar  to  tha  firat  lino  of  buf  to  diaplay. 

•  inaal  -  A  pointar  to  tha  lina  which  ia  a  terminua  of  tha  aalact 

•  ran go.  It  ia  NULL  if  no  aalact  ranga  ia  activa. 

• 

•  aol  -  Buf far  which  containa  tha  contanta  of  tha  paata  buf far. 

>>  load  taat.dat 

Mag!  |  0 [  applcatlon 

B-3  After  Delete  Line,  Before  Paste 


B-4 
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•  are  pointed  to  by  x_tof  and  xjbof  respectively.  tdiare  x  ia  tha  name 

•  o f  tha  buffer.  Tha  noda  structura  ia  denotad  by  tha  struct 

•  "TEXT_L INE  " .  Tha  sain  buffer  containing  tha  fils  being  edited  has 

•  several  other  pointers  which  indicate  tha  first  line  to  bo  displayed. 

•  tha  lino  containing  tha  cursor  and  a  lino  which  is  a  terminus  of  tha 

•  select  range. 

If  the  systae  is  heavily  loaded,  like  it  coaaonly  is  in  tha  afternoon 
around  here,  the  response  is  very  slow  and  unacceptable.  Edt  is  highly 
optimized  to  run  an  doc  terminals  and  even  it  runs  slowly.  Bo  you  can  imagine 
what  this  guy  is  like.  On  pressing  any  function  key  you  casually  walk  down  to 
the  coffee  machine,  leasurely  fill  a  cup  and  say  hi  to  all  yoir  neighbors 
while  on  your  way  back  to  your  office. 

•  buf  -  Buffer  which  contains  the  contents  of  the  file  being  edited. 

•  buf_tof  -  A  pointer  to  the  buf’s  header  node. 

•  buf_bof  -  A  pointer  to  tha  buf's  trailer  node. 

•  cur_row  -  A  pointer  to  the  line  containing  tha  cursor. 

•  buf_start  -  A  pointer  to  the  first  line  of  buf  to  display. 

•  insel  -  A  painter  to  tha  line  which  is  a  terminus  of  the  select 

•  range.  It  is  NULL  if  no  aalaet  range  is  active. 

• 

*  sal  -  Buffer  which  contains  the  contents  of  the  paste  buffer. 

>>  load  tmxt.dat 
Msg:  [~o] 


applcat ion 
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tha  response  is  vary  alo»  and 
inacceptable.  Edt  is  highly 
opt  tailed  to  run  an  dec 
tarainala  and  avan  it  runs 
alowly.  So  you  can  imagine 
Mhat  this  guy  is  Ilka.  On 
pressing  any  function  kay  you 
casually  walk  down  to  tha 
coffee  Mchlnat  laasuraly 
fill  a  cup  and  say  hi  to  all 
your  neighbors  while  on  your 
way  back  to  your  office. 

•  buf  -  Buffer  which  contains  the  contents  of  the  file  being  edited. 

•  buf_tof  -  A  pointer  to  the  buf's  header  node. 

•  buf_bof  -  A  pointer  to  the  buf's  trailer  node. 

•  cur_row  -  A  pointer  to  the  line  containing  the  cursor. 

•  buf_start  -  A  pointer  to  tha  first  line  of  buf  to  display. 

•  inset  -  A  pointer  to  tha  line  which  is  a  terminus  of  the  select 

•  range.  It  is  NULL  if  no  select  range  is  active. 

• 

•  eel  -  Buffer  which  contains  the  contents  of  the  paste  buffer. 

>  >  load  test .  dat 

Msg:  |  O  I  applcat ion 


B-5  After  Fill 


B-6 
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APPENDIX  C 


Keypad  layouts  for  VT100  in  applioation  mode 


Figure  C-l  Applioation  Mode 


Figure  C-2  Text  Edit  Mode 


si 


